﻿<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
	<head>
		<title>Documentation</title>
	</head>
	<body style="font-family:Tahoma">
	<h3 style="text-align: center">Yet another pali text reader</h3>
	<h2 style="text-align: center">Background</h2>
<p>This program is inspired by several abandoned projects including</p>	
        <ol>
            <li>Pali Text Reader (<a href="http://palireader.sourceforge.net/">http://palireader.sourceforge.net/</a>)</li>
            <li>Chattha Sanghayana Tipitaka 4.0 (<a href="http://www.tipitaka.org/cst4">http://www.tipitaka.org/cst4</a>)</li>
            <li>Digital Pali Reader (<a href="http://sourceforge.net/projects/digitalpali/">http://sourceforge.net/projects/digitalpali/</a>)</li>
        </ol>

	    <h2 style="text-align: center">System Requirements</h2>
	    <ol>
            <li>Windows XP or better (Vista, Windows 2003, Windows 7)</li>
            <li>Microsoft .NET Framework 2.0</li>
            <li style="color: #0066FF">Microsoft SQL Server Compact 3.5 SP1</li>
            <li>50 mb of disk space if search facility is not used, about 170 mb otherwise</li>
        </ol>
	<h2 style="text-align: center">Installation</h2>
	<p>The program is licensed as free sotware under GNU GPL v2 licence. 
	You will have to accept the licence agreement in the process of installation.</p>
	
	<p>Installation requires two separate packages to be downloaded: application installer and library installer.
	You can download them <a href="http://palitextreader.codeplex.com/Release/ProjectReleases.aspx">Here</a>
        <br />
        Click on &quot;Pali Text Reader App v1.2&quot; in the "Releases" box and then click on PTR2Install.zip. 
        Click &quot;I Agree&quot; to accept licence agreement and your download will start.
        <br />
        Click on &quot;Pali Canon Library v1.0&quot; and do the same to download the library package 
        LibraryInstall.msi.</p>
        <p>You must have administrator permissions to install. However, they are not required to run an installed application.</p>
        <p><b>Installing pali canon library</b></p>
        <p>Run LibraryInstall.msi, follow the installation wizard. 
        You can specify a folder in which the library will be installed. Make sure you have enough 
        disk space for the search index if you plan to use search.</p>
        <p style="text-decoration: underline">If you plan to run the program from a limited user account, you should set write permissions
        for this account to the library folder.</p>
        <p>
            <b>Installing the main application</b></p>
        <p>Unzip two files from PTR2Install.zip and run setup.exe. Follow the wizard to complete the 
        installaion. If your computer is connected to the internet and you don't have 
        MS SQL Server Compact 3.5 SP1 installed, the installer will try to install it from Microsoft Website.
        You can also download and install it manually from 
        <a href="http://www.microsoft.com/downloads/details.aspx?FamilyID=dc614aee-7e1c-4881-9c32-3a6ce53384d9&amp;displaylang=ru">Microsoft website</a>
        </p>
<h2 style="text-align: center">Running the application</h2>            
	    <p>You can run the application with a PaliTextReader2 shortcut created in Start - All programs menu.
        </p>
<h2 style="text-align: center">Usage</h2>
        <p>Use the main toolbar to access all the features.</p>
        <p><b>Opening books</b></p> 
	    <p>
            Click <i>Open book</i> toolbar button. A dialog is shown with several tabs which you can use 
            to browse for of find a book (sutta, heading etc).</p>
        <p>
            You can search in the content database to find a sutta (heading, named passage and so on). 
            Switch to <i>Search names</i> tab, type the name and click Find. The search looks for matches 
            from the beginning of the name by default, however, many suttas begin with a number. 
            If you want to search in any part of the name and find these suttas as well,
            change search mode to "Contains".
            <br />
            If your search returned results, select the one you need and click OK button.
</p>
        <p>
            <b>Working with dictionary</b></p>
        <p>
            You can look up words in ven. Buddhadatta Concise Pali-English dictionary.
            To do this, select a word and then right-click on it. 
            Pick "Lookup word" from the context menu.
        </p>
	    <p>Use &quot;Toggle dictionary&quot; toolbar button to show or hide the dictionary window.</p>
        <p>You can now add and edit terms by clicking on them in the search results tab.</p>
        <p>
            <b>Working with books</b></p>
        <p>You can use &quot;Book navigation&quot; dialog to navigate within the open book to jump to 
            headings or PTS pages. Click &quot;Book navigation&quot; toolbar button to open this 
            dialog.</p>
        <p>You can search text in the open book by clicking &quot;Search in this book&quot; toolbar button.</p>
        <p>You can bookmark pages by clicking &quot;Bookmark this page&quot; toolbar button. 
        Use Open book - bookmarks tab to return to a bookmark.</p>
        <p>You can change the book display settings (fonts, colors etc) in style.css file located in the 
        program installation folder.</p>
        <p>
            <b>Searching the Pali Canon</b></p>
        <p>Click &quot;Search tipitaka&quot; toolbar button to enter the search mode.
        Type a search word or phrase and click Find.</p>
        <p>Search is performed in all books by default, but you can select a 
        particular book in which to search.</p>
        <p>The program will find exact matches only, but you can use * and ? wildcards. 
            <br />
            If you want to find matches with any part of the word, surround the search term with asterisks,
            for example *buddh*.</p>
        <p>Double-clicking the book in the "found books" list will open it in a new window.</p>
        <p>
            &quot;Ignore pali diacritics&quot; can be used to search for one word (not a phrase). The program will find exact matches only, but you can use * and ? wildcards. 
            If you want to find matches with any part of the word, surround the search term with asterisks,
            for example *buddh*.</p>
        <p>
            <b>Searching Pali Text Society Pali-English Dictionary</b></p>
        <p>Type a search word or phrase and select &quot;&lt;Pali-English Dictionary&gt;&quot; in the 
        list next to Find button. First search will require indexing.</p>
        <p>
            <b>Entering special pali symbols</b></p>
        <p>You can use the following key combinations in order to enter pali-specific symbols:</p>
        <p>
            Alt + a, i, u, d, t, l, m, n = ā, ī, ū, ḍ, ṭ, ḷ, ṃ, ṇ<br />
            Alt + g = ṅ<br />
            Alt + j = ñ</p>
        <p>
            <b>Closing the program</b></p>
        <p>Click the Exit toolbar button. The program will remember all the open books and will reopen 
        them on next start-up. It remembers scroll position as well!</p>
 <h2 style="text-align: center">About the author</h2>
	    <p>
            This sofware is written by Upasaka Khantibalo from Moscow, 2009-2010. contact: 
            khantibalo AT live.ru<br />
            Website: <a href="http://palitextreader.codeplex.com/">
            http://palitextreader.codeplex.com/</a></p>

	</body>
</html>